home *** CD-ROM | disk | FTP | other *** search
/ NeXT Education Software Sampler 1992 Fall / NeXT Education Software Sampler 1992 Fall.iso / Utilities / TarChive / mtsense.c < prev    next >
Encoding:
C/C++ Source or Header  |  1992-08-24  |  9.4 KB  |  300 lines
  1.  
  2.  
  3. /*
  4.  How to make the MT-02 SCSI tape drive useable ...
  5.  
  6.     *****This post has no warranty*****
  7.  
  8. NeXT Answers hardware.762 gives details of how to set the NeXT st
  9. driver into fixed block mode, allowing it to work with QIC style tape
  10. drives.  This has enabled my tape drive to work, but my drive has
  11. performed badly, often bombing out with write errors. I knew it wasn't
  12. the drive or the media because they both work when connected to a sun,
  13. and the tape works in other drives. The clue came from the NeXT
  14. Console where I found the following message.
  15.  
  16. st: cmd = 0xa sr_io_status = 2H
  17.     Sense key = 0x1  Sense Code = 0x0
  18.  
  19. A sense key of 0x1 indicates a recoverable error, ie one that the tape
  20. drive fixed, e.g. a write failed but was sucessful on a subsequent
  21. retry (provided the max retry limit wasn't reached). Some tape drivers
  22. report the number of recoverable errors, and on some machines "mt
  23. status" will report the number.
  24.  
  25. Anyway it turns out that the MT-02 tape controller has a bit which
  26. controls how it handles soft errors. The default case when connected
  27. to a NeXT is to for the tape drive to issue a CHECK CONDITION status
  28. code after it executes a command if a recoverable error occured. The
  29. NeXT st driver seems to handle this as if it were a real error and
  30. bombs out at this point. The other mode is to have the drive
  31. accumulate the number of soft errors, so that they can be collected
  32. later by the REQUEST SENSE command.
  33.  
  34. The following tape utility adds to the code in NA.762 and gives the
  35. option of setting the SEC bit. It also allows the user to set the
  36. driver back to variable block mode, and execute the MODE SENSE and
  37. REQUEST SENSE scsi commands.
  38.  
  39.  
  40.  
  41. Mark Andrews
  42. abekas!mark@pyramid.com        <non-NeXT mail>
  43. abekas!cookie!mark@pyramid.com    <NeXT mail ok>
  44.  
  45. */
  46.  
  47.  
  48. /* */
  49. /* NeXT scsi tape driver utility */
  50. /* Mark Andrews 1992 */
  51. /* This Code is Supplied as is with NO WARRANTY of any kind */
  52. /* No resposibility can or will be accepted for any damage that using */
  53. /* this program may cause */
  54. /* It has only been tested on a SCSI tape drive with an MT-02 tape controller */
  55. /* Note the SEC bit is part of the VENDOR unique stuff and may or may not */
  56. /* work with other drives.  In particular it doesn't work with Exabyte. */
  57. /* The MTIOCFIXBLK code is from NA.562 */
  58. /* The REQUEST SENSE code is from a posting by louie@sayshell.umd.edu 3/10/92 */
  59. /* */
  60.  
  61. #include <stdio.h>
  62. #include <libc.h>
  63. #include <sys/types.h>
  64. #include <sys/file.h>
  65. #include <sys/mtio.h>
  66. #include <nextdev/scsireg.h>
  67.  
  68. #define    SEC    0x1
  69. #define    QUIET    0
  70. #define    VERBOSE    1
  71.  
  72. char *tape_name;
  73. int tape;
  74. struct modesel_parms msp;
  75. struct scsi_req sr;
  76.  
  77. main(argc,argv)
  78. int argc;
  79. char *argv[];
  80. {
  81.   char c;
  82.   int sf,sv,ms,rs,sc;
  83.  
  84.   sf=sv=ms=rs=sc=0;
  85.   
  86.   
  87.  
  88.  
  89. /*        strcpy(tape_name,"/dev/rst0");*/
  90. tape_name=getenv("TAPE");
  91. if  (tape_name == 0) tape_name = "/dev/nrxt0" ;
  92.  
  93.  
  94.  
  95.   while((c=getopt(argc,argv,"hvrmsf:b:")) !=EOF)
  96.     {
  97.     if(c=='f') strcpy(tape_name,optarg);/* set device from cmd lineman */
  98.     if(c=='b') if(optarg!=NULL)sf=atoi(optarg);else sf=512;    /* set to fixed block mode */
  99.     if(c=='v') sv=1;        /* set to variable block mode */
  100.     if(c=='m') ms=1;        /* mode sense */
  101.     if(c=='r') rs=1;        /* request sense */
  102.     if(c=='s') sc=1;        /* set the soft error bit */
  103.     if(c=='h')             /* print usage */
  104.       fprintf(stderr,"Usage: %s -hvrmsnf [block size]\n%s%s%s%s%s%s%s",argv[0],
  105.     "\t-h   : print usage,\n",
  106.     "\t-b # : set fixed block mode with size #,\n",
  107.     "\t-v   : set variable block mode,\n",
  108.     "\t-m   : do a mode sense command and report the results,\n",
  109.     "\t-r   : do a request sense command and report the results,\n",                
  110.     "\t-s   : set the soft error bit, (not valid on exabyte)\n",
  111.     "\t-f   : use device named.\n");
  112.     }
  113.  
  114. printf("Using tape drive: %s\n",tape_name);
  115.  
  116.   /* open /dev/rxt0 */
  117.   if((tape=open(tape_name,O_RDWR,777))==0)
  118.     {
  119.     fprintf(stderr,"Unable to open %s\n",*tape_name);
  120.     exit(1);
  121.     }
  122.  
  123.   if(sv)
  124.     {
  125.     if(!sf)
  126.       set_var_blk();
  127.     else
  128.       {
  129.       fprintf(stderr,"Can't set to both fixed and variable block mode\n");
  130.       problem();
  131.       }
  132.     }
  133.   if(sf) set_fix_blk(sf);
  134.   if(ms) mode_sense(VERBOSE);
  135.   if(rs) request_sense();
  136.   if(sc) set_sec();
  137.  
  138.   /* close tape */
  139.   close (tape);
  140.   exit(0);
  141. }
  142.  
  143. problem()
  144. {
  145.   /* close tape */
  146.   close (tape);
  147.   exit(-1);
  148. }
  149.  
  150. mode_sense(verbose)
  151. int verbose;
  152. {
  153.   /* do a mode sense ioctl */
  154.   msp.msp_bcount=17; /*  think this is correct */
  155.   if(ioctl(tape,MTIOCMODSEN,&msp))
  156.     {
  157.       perror("mode sense ioctl failed\n");
  158.       exit(1); 
  159.     }
  160.   if(!verbose)
  161.     return;
  162.   /* print out the returned data */
  163.   fprintf(stdout,"mode sense data length  = %d\n",(int)msp.msp_data.msd_header.msh_sd_length_0);
  164.   fprintf(stdout,"media type              = %d\n",(int)msp.msp_data.msd_header.msh_med_type);
  165.   if(msp.msp_data.msd_header.msh_wp)
  166.     fprintf(stdout,"tape is                 = write protected\n");
  167.   else
  168.     fprintf(stdout,"tape is                 = writeable\n");
  169.    
  170.   fprintf(stdout,"buffered mode           = %d\n",(int)msp.msp_data.msd_header.msh_bufmode);
  171.   fprintf(stdout,"speed                   = %d\n",(int)msp.msp_data.msd_header.msh_speed);
  172.   fprintf(stdout,"block descriptor length = %d\n",(int)msp.msp_data.msd_header.msh_bd_length);
  173.   fprintf(stdout,"density code            = %d\n",(int)msp.msp_data.msd_blockdescript.msbd_density);
  174.   fprintf(stdout,"number of blocks        = %d\n",(int)msp.msp_data.msd_blockdescript.msbd_numblocks);
  175.   fprintf(stdout,"block length            = %d\n",(int)msp.msp_data.msd_blockdescript.msbd_blocklength);
  176.   fprintf(stdout,"vendor unique byte[0]   = %d\n",(int)msp.msp_data.msd_vudata[0]);
  177.   fprintf(stdout,"vendor unique byte[1]   = %d\n",(int)msp.msp_data.msd_vudata[1]);
  178.   fprintf(stdout,"vendor unique byte[2]   = %d\n",(int)msp.msp_data.msd_vudata[2]);
  179.   fprintf(stdout,"vendor unique byte[3]   = %d\n",(int)msp.msp_data.msd_vudata[3]);
  180.   fprintf(stdout,"vendor unique byte[4]   = %d\n",(int)msp.msp_data.msd_vudata[4]);
  181. }
  182.  
  183. mode_slct()
  184. {
  185.   /* this routine assumes that the msp structure has already been */
  186.   /* initialized, a mode_sense is the best way to do this */
  187.  
  188.   /* do a mode select ioctl */
  189.   if(ioctl(tape,MTIOCMODSEL,&msp))
  190.     {
  191.       perror("mode select ioctl failed\n");
  192.       return 1; 
  193.     }
  194. }
  195.  
  196. set_sec()
  197. {
  198.  
  199.   mode_sense(QUIET);                /* do a mode sense */
  200.   msp.msp_data.msd_vudata[0]|=SEC;    /* set the SEC bit */
  201.   fprintf(stdout,"setting no report for soft errors\n");
  202.   mode_slct();                /* do a mode select */
  203. }
  204.  
  205. set_fix_blk(blocksize)
  206. int blocksize;
  207. {
  208.  
  209.   if(ioctl(tape,MTIOCFIXBLK,&blocksize))
  210.     {
  211.     perror("fixed block ioctl failed\n");
  212.     return 1; 
  213.     }
  214. /* The following section added to set the drive to be the same as */
  215. /* the driver.  sgb */
  216.   msp.msp_data.msd_blockdescript.msbd_blocklength=blocksize;
  217.   fprintf(stdout,"tape is set for fixed blocks of %i\n",blocksize);
  218.  
  219.   mode_slct();
  220. }
  221.  
  222.  
  223. set_var_blk()
  224. {
  225.  
  226.   if(ioctl(tape,MTIOCVARBLK))
  227.     {
  228.     perror("variable block ioctl failed\n");
  229.     return 1; 
  230.     }
  231. /* The following section added to set the drive to be the same as */
  232. /* the driver.  sgb */
  233.  fprintf(stdout,"tape is set for variable blocks\n");
  234.  msp.msp_data.msd_blockdescript.msbd_blocklength=0;
  235.  mode_slct();
  236.  
  237. }
  238.  
  239. request_sense()
  240. {
  241.   /* set up sr */
  242.   bzero(&sr, sizeof(sr));
  243.   sr.sr_dma_dir=SR_DMA_RD;
  244.   sr.sr_dma_max=sizeof(sr.sr_esense);
  245.   sr.sr_addr=(caddr_t)&sr.sr_esense;
  246.   sr.sr_ioto=2;
  247.   sr.sr_cdb.cdb_c6.c6_opcode=C6OP_REQSENSE;
  248.   sr.sr_cdb.cdb_c6.c6_len=sizeof(sr.sr_esense);
  249.  
  250.   /* execute the request sense */
  251.   if(ioctl(tape,MTIOCSRQ,&sr))
  252.     {
  253.     perror("request sense ioctl failed\n");
  254.     return 1; 
  255.     }
  256.  
  257.   /* print the answers */
  258.   fprintf(stdout,"io status               = %d\n",(int)sr.sr_io_status);
  259.   fprintf(stdout,"scsi status             = %d\n",(int)sr.sr_scsi_status);
  260.   fprintf(stdout,"bytes dma'd             = %d\n",(int)sr.sr_dma_xfr);
  261.   fprintf(stdout,"sense info bytes are    =");
  262.   if(sr.sr_esense.er_ibvalid)
  263.     fprintf(stdout,"valid\n");
  264.   else
  265.     fprintf(stdout,"not valid\n");
  266.   fprintf(stdout,"error class             = %d\n",(int)sr.sr_esense.er_class);
  267.   fprintf(stdout,"error code              = %d\n",(int)sr.sr_esense.er_code);
  268.   fprintf(stdout,"segment number          = %d\n",(int)sr.sr_esense.er_segment);
  269.   fprintf(stdout,"file mark found         = ");
  270.   if(sr.sr_esense.er_filemark)
  271.     fprintf(stdout,"yes\n");
  272.   else
  273.     fprintf(stdout,"no\n");
  274.   fprintf(stdout,"end of medium           = ");
  275.   if(sr.sr_esense.er_endofmedium)
  276.     fprintf(stdout,"yes\n");
  277.   else
  278.     fprintf(stdout,"no\n");
  279.   fprintf(stdout,"incorect length         = ");
  280.   if(sr.sr_esense.er_badlen)
  281.     fprintf(stdout,"yes\n");
  282.   else
  283.     fprintf(stdout,"no\n");
  284.   fprintf(stdout,"sense key               = %d\n",(int)sr.sr_esense.er_sensekey);
  285.   fprintf(stdout,"residue length          = %d\n",(int)sr.sr_esense.er_info+((int)sr.sr_esense.er_infomsb<<24));
  286.   fprintf(stdout,"additional sense length = %d\n",(int)sr.sr_esense.er_addsenselen);
  287.   fprintf(stdout,"additional sense code   = %d\n",(int)sr.sr_esense.er_addsensecode);
  288.   fprintf(stdout,"sense code qualifier    = %d\n",(int)sr.sr_esense.er_qualifier);
  289.   fprintf(stdout,"status byte 13          = %d\n",(int)sr.sr_esense.er_stat_13);
  290.   fprintf(stdout,"status byte 14          = %d\n",(int)sr.sr_esense.er_stat_14);
  291.   fprintf(stdout,"status byte 15          = %d\n",(int)sr.sr_esense.er_stat_15);
  292.   fprintf(stdout,"recoverable errors      = %d\n",(int)sr.sr_esense.er_err_count);
  293. }
  294.  
  295. /*            Additional Credits:*/
  296. /*     nigelm@ohm.york.ac.uk (Nigel Metheringham)*/
  297. /*         bug in -f setting*/
  298. /*        consisting in printing what drive is being used.*/
  299.  
  300.